ParcelTrack API
Environments and Testing
##Overview
You, as an integrating partner, are expected to maintain your own development, test and production environments from which to call the corresponding NZ Post Group environment and to follow the software development lifecycle.
##Environment Detail
| Name | Use | Addresses |
|---|---|---|
| NZ Post Group User Acceptance Test (UAT) Environment | This environment is available for integration to test your solutions to ensure that calls to the API’s are technically correct and that the responses received are handled as they expect. This environment is available for system, integration and user acceptance testing. | https://api.uat.nzpost.co.nz/parceltrack/v4/ |
| Production Environment | This environment is for live use and is only available upon completion of the go-live checklist. | https://api.nzpost.co.nz/parceltrack/v4/ |
##Testing Your Application
NZ Post Group is committed to making integration to its products easy and robust and are available to support your development and testing.
As with any development, NZ Post Group encourages you to test your application with both positive and negative scenarios. The following list of test cases has been provided for your convenience but it is not intended to be comprehensive. Some test cases may not apply to your use of the API. Please extend with test cases specific to your business.
| Suggested Test Cases - for both internal and external user | Expected Results |
|---|---|
| Query single valid IPS tracking reference | All events associated with the tracking reference are returned |
| Query single valid Pace job number | All events associated with the job number are returned |
| Query single valid Parcel Store tracking reference | All events associated with the tracking reference are returned |
| Query single valid tracking reference not in CourierPost, Pace, IPS and Parcel Store | All events associated with the tracking reference are returned |
| Query two valid CourierPost tracking references | All events associated with the two tracking references are returned |
| Query two valid Pace job numbers | All events associated with the two job numbers are returned |
| Query two valid Parcel Store tracking references | All events associated with the two tracking references are returned |
| Query Single Valid Pace Tracking Reference & Single Valid CourierPost Tracking Reference & Single Valid IPS Tracking Reference & Single Valid Parcel Store Tracking Reference & Single Tracking Reference not in CourierPost, Pace, IPS & Parcel Store | All events associated with the queried tracking references are returned |
| Query five valid Pace job numbers & five valid CourierPost tracking reference | All events associated with the Pace job numbers and CourierPost tracking references are returned |
| Query more than ten tracking references | Response includes error indicating "The number of tracking references must be between 1 and 10." |